功能分析：圖書館管理系統

在我們開始動手寫程式去實作圖書館管理系統之前，首先可以先來分析一下，在這個圖書館的管理系統中，我們想要提供什麼樣的功能。

像是圖書館管理系統顧名思義，就是用來管理「書」的，所以我們針對「書」這個資源，就可以去實作他的 CRUD 四大基本操作，也就是「新增一本書」、「查詢某一本書」、「更新某本書的資訊」、「刪除某一本書」。

因此下面就會分別來介紹，要如何在 Spring Boot 中設計和實作出「書」的 CRUD 四個功能，完成一個簡易的圖書館管理系統。

資料庫 table 設計

在設計資料庫 table 時，因為是針對「書本」這個資源來設計，因此我們可以設計一個 book table，去儲存書本的相關資訊。以下是創建 book table 的 SQL 語法：

CREATE TABLE book
(
    book_id            INT          NOT NULL PRIMARY KEY AUTO_INCREMENT,
    title              VARCHAR(128) NOT NULL,
    author             VARCHAR(32)  NOT NULL,
    image_url          VARCHAR(256) NOT NULL,
    price              INT          NOT NULL,
    published_date     TIMESTAMP    NOT NULL,
    created_date       TIMESTAMP    NOT NULL,
    last_modified_date TIMESTAMP    NOT NULL
);

其中各個欄位的含義如下：

• book_id：表示 book 的唯一 id，由資料庫自動遞增
• title：表示此書的書名
• author：表示此書的作者
• image_url：儲存此書的圖片連結
• price：此書的販售價格
• published_date：此書的上架時間
• created_date：創建這筆數據的時間
• last_modified_date：最後修改這筆數據的時間

實作「查詢某一本書」的功能

通常在實作基礎的 CRUD 功能時，建議可以先從「查詢功能」開始實作，因此我們就先從「查詢一本書」這個功能開始實作。

BookController（Controller 層）的實作

首先我們可以先在 BookController 中，添加如下的程式：

@GetMapping("/books/{bookId}")
public ResponseEntity<Book> getBook(@PathVariable Integer bookId) {
    Book book = bookService.getBookById(bookId);

    if (book != null) {
        return ResponseEntity.status(HttpStatus.OK).body(book);
    } else {
        return ResponseEntity.status(HttpStatus.NOT_FOUND).build();
    }
}

補充：由於程式的篇幅過長，因此本文中只會擷取部分重點來介紹，完整的程式碼可以前往 GitHub springboot-library 查看。

在 BookController 中，因為他是屬於 Controller 層，所以他會使用 @GetMapping，去接住前端放在 url 路徑中的 bookId 的參數。

而在接到 bookId 的值之後，BookController 就會直接往後傳給 BookService 去做後續處理，即是將商業邏輯寫在 Service 層，讓 Controller 層保持「和前端溝通」的部分。

而當 BookService 返回查詢到的 book 數據之後，BookController 就可以根據「是否有查詢到數據與否」，去決定要返回給前端的 Http status code 為何。

像是在下面的程式中，if 區塊就呈現出「當 book 不為 null 時，就返回 200 OK 的 Http status code 給前端，並且把 book 數據放在 response body 中」的資訊。而在 else 區塊中，則是呈現「當 book 為 null 時，就返回 404 Not Found 的 Http status code 給前端」。

if (book != null) {
    return ResponseEntity.status(HttpStatus.OK).body(book);
} else {
    return ResponseEntity.status(HttpStatus.NOT_FOUND).build();
}

BookService（Service 層）的實作

實作完 BookController 之後，接著我們往下實作 BookService。

當 BookService 收到 Controller 傳過來的 bookId 之後，因為這裡的邏輯比較簡單，沒有太複雜的商業邏輯要處理，因此 BookService 就只要直接去 call BookDao 的方法，交由 Dao 層去資料庫查詢數據即可。

public Book getBookById(Integer bookId) {
    return bookDao.getBookById(bookId);
}

BookDao（Dao 層）的實作

而在 BookDao 這裡，因為他是 Dao 層，負責和「資料庫」溝通，因此就可以在這裡使用 Spring JDBC 的 query() 方法，在資料庫中執行 SELECT SQL，去查詢這一筆 bookId 的數據出來。

public Book getBookById(Integer bookId) {
    String sql = "SELECT book_id, title, author, image_url, price, published_date, created_date, last_modified_date " +
            "FROM book WHERE book_id = :bookId";

    Map<String, Object> map = new HashMap<>();
    map.put("bookId", bookId);

    List<Book> bookList = namedParameterJdbcTemplate.query(sql, map, new BookRowMapper());

    if (bookList.size() > 0) {
        return bookList.get(0);
    } else {
        return null;
    }
}

因此到這邊，「查詢某一本書」的功能就實作完畢了！

API Tester 實際測試

因為目前 book table 中沒有任何數據，因此在測試「查詢某一本書」的功能之前，我們需要先在 IntelliJ 的 console 中執行下列的 SQL 語法，手動插入一筆數據到 book table 中。

INSERT INTO book (title, author, image_url, price, published_date, created_date, last_modified_date) VALUES ('先問，為什麼？：顛覆慣性思考的黃金圈理論，啟動你的感召領導力', '賽門‧西奈克', 'https://im1.book.com.tw/image/getImage?i=https://www.books.com.tw/img/001/092/65/0010926506.jpg', 331, '2018-05-23 00:00:00', '2023-10-14 02:42:02', '2023-10-14 02:42:02');

插入這本書的數據之後，接著就可以在 API Tester 中，填上以下的參數設定，來測試「查詢某一本書」的功能：

填寫完成之後，就可以按下 Send 鍵進行測試，結果如下：